USPS Pricing Engine SDK 


January 18, 2017. 


Summary 
This is the Domestic and International Pricing Engine SDK (version 11.5.0.0) for Sprint 8 of the January 
22, 2017 Release. The following is a list of enhancements included in this release. 


BNS 483 - COD Redesign 
e “Collect on Delivery” is renamed to “Collect on Delivery Hold For Pickup” 
e “Collect on Delivery Restricted Delivery” is renamed to “Collect on Delivery Hold For Pickup 
Restricted Delivery” 
“Registered Mail™ COD Collection Charge” is renamed to “Registered Mail™ COD HFPU 
Collection Charge” 


This BNS has been canaled for the January 2017 Price Change. 


BNS 530 - International Dynamic Prefix Bar Code Assignment 

The International Pricing Engine will return the ECOMPRO postage services for the countries listed 
below in the “ECOMPRO Countries” table. The Priority Mail International postage service will not be 
returned for these countries. The |Dsand Names for ECOMPRO postage services will match the Priority 
Mail International postage services (see the “ECOMPRO Postage Service” table). All international 
customer maps that return will now also return ECOMPRO. A Mail Type Code of “C” has been added to 
the Group Code to identify the mail service as ECOMPRO. The attribute “ECOMPRO” has also been 
added to farther identify the Postage Service as “ECOMPRO”. The “ECOMPRO” attribute will be set to 
“True” for is ECOMPRO or “False” for is not ECOMPRO. The Country class member TypeOf has been 
updated to be a 16 digit off/on bit map where index 0 will indicate that the country does or does not 
support ECOMPRO. 


Code Segment to Accessthe ECOMPRO Setting 
int ecompro_index = 0; 
bool has_ecompro = (((1 << (ecompro_index)) & Country. TypeOf) > 0); 


ECOMPRO Countries 
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VietNam OOOO 


Viet Nam 
*For COMMERCIAL only 


ECOMPRO Postage Service 
| GroupCode ID | Name 


Priority Mail International® Legal Flat Rate Envelope 
Priority Mail International® Padded Flat Rate Envelope 
Priority Mail International® Gift Card Flat Rate Envelope 


Priority Mail International® Small Flat Rate Envelope 
Priority Mail International® Window Flat Rate Envelope 


a 


BNS 548 - Premium Forwarding Service Commercial Flat Rate Containers - 
Half Tray and Full Tray 


The calculator will support the Half Trayand Full Tray prices for Premium Forwarding Service as an 
addition to the Mailing Fees functionality. 


Keys: 
e PremiumForwardingService.Commercial.PriorityMailExpress.HalfTray 
e PremiumForwardingService.Commercial.PriorityMailExpress. FullTray 
e PremiumForwardingService.Commercial.PriorityMail.HalfTray 
e PremiumForwardingService.Commercial.PriorityMail.FullTray 


BNS 600 - Standard Mail 


The “Standard Mail” mail service is renamedto “USPS Marketing Mail”. 


BNS 392 - Standard Mail Presort Letters - Reduce Simple Sample Tiers 
The Pricing Engine has been updated with the following changes: 
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Standard Mail (USPS Marketing Mail) Letters and Standard Mail (USPS Marketing Mail) 
Nonprofit Letters 


Automation and Carrier Route Letters 
Eliminated “3-Digit” Price Category and Piece / Pound pricing 


Nonmachinable and Carrier Route Nonautomation Letters 
Updated to have 2 pricing tiers; "up to 4 ounces" and "more than 4 ounces." 


Standard Mail (USPS Marketing Mail) Letters and Standard Mail (USPS Marketing Mail) 
Nonprofit Parcels 


Standard Mail Carrier Route Parcels - Simple Samples 
Reduced pricing tiers from 6 to 2; 1-200,000 pieces and over 200,000 pieces. 


BNS 411 - First Class Mail Presort 


First-Class Mail Automation Postcards and Letters 
Eliminated the “3-Digit” price category. 


BNS 560 - Create 3rd ounce free for FCM commercial letters only and evaluate 


residual mail impacts 
First-Class Mail Letters up to 3.5 ounces will have the same price. 


Updated for Sprint 4 
"Residual Nonpresorted" and "Nonpresorted/Single-Piece" have been deleted from First-Class Mail 
Letters. 


BNS 561 - Adjust Standard Mail FSS pricing to minimize customer impact and 


also maximize contribution 
All FSS pricing have been removed from Standard Mail (USPS Marketing Mail) Flats. 


BNS 562 - Provide a Simple Price Structure for Standard Mail 
The price break for Standard Mail (USPS Marketing Mail) Flats and Standard Mail (USPS Marketing Mail) 
Nonprofit Flats has been changed from 3.3 to 4 ounces. 


BNS 593 - Modify FSS for Bound Printed Matter 
All FSS pricing have been removed from Bound Printed Matter Flats 


BNS 580 - Alternate Postage Name Change to Share Mail and elimination of 
two pricing tiers 
Added Share Mail to and removed Alternate Postage from Mailing Fees interface. 


Keys: 
e ShareMail.FCM. Postcards 
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e ShareMail.FCM.Letters 


Add Shipping Date to the Mailing Fees Request 
An optional field has been added to the Mailing Fees Request for the Shipping Date. The default value 
for the field is Today withthe Time the request was submitted. 


BNS 595 - Regulatory Rate Change (Competive and Market Dominate) 
Prices have been updated in existing price cells for all classes of mail for both Market Dominant and 
Competitive including extra services and fees. 


BNS 595 - Update Price Cells per Price File dated 
e USPS Marketing Mail NONPROFIT Letters 
o Carrier Route 
= Basic 
e DNDC-0.179 
e DSCF -0.171 


Updated version number and sign all DLLs 
All the libraries have been update to version 11.5.0.0 and re-signed. 


Updated databases 
New databases have been created for this release: USPS_DOM_2017_01 and USPS_INTL_2017_01 for 
domestic and international respectively. 


Update ServiceDeliveryExtensions.KPGProvider to use 


TextWithLinksBusiness 
This is a result of an internal effort to merge the retail engine and business engines into a single engine. 


Update the AnnotationManager in both Domestic and International Engines to 


update TextWithLinksBusiness 
This is a result of an internal effort to merge the retail engine and business engines into a single engine. 


Update the Customs Forms Library to use the Business SQL Tables 
This is a result of an internal effort to merge the retail engine and business engines into a single engine. 


Updated Pricing Engine to use prepared SQL statements 


This is one of a number of performance improvements derived from the performance study performed 
in August 2016. 


Cache Dimensions Table 


This is one of a number of performance improvements derived from the performance study performed 
in August 2016. 
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SQL improvements (indexes and primary Keys) 


This is one of a number of performance improvements derived from the performance study performed 
in August 2016. 


Update Pricing Engine to pull FCM Letters Nonmachinable Surcharge from 
Database 


The Domestic and International Pricing Engines where updated to pull the following fees from the 
database, then where hardcoded. 


e Nonmachinable Surcharge 
e Sunday / Holiday Delivery Fee 
e 10:30 AM Delivery Fee 


Add Max Country Values validation to the International Pricing Engine 
Made updates to the Pricing Engine to validate the Maximum Value of the item based on country. A new 
attribute “ValueMax” is returned for each Mail Service. 


Move Piece / Pound Weight Break to Database 
The Domestic and International Pricing Engines where updated to pull the Piece / Pound Weight Break 
from the database. 


BNS 595.5 - EDDMR_RCALC_CR v1 - Customer Map 
Added Customer Map for EDDM-R, customer key is O28R6. The customer map support all pricing for the 


EDDM mailservices including EDDM Retail and EDDM Carrier Route. 


BNS 595.5 - EDDMR_RCALC_CR v1 - Add Effective Date 
Updated the response to include the “Effective Date” for the following Domestic and International 
methods: 


GetServciesWithPricing 
CalculateServicePrice 
ExtraServicesWithPricing 
MailingFee 


The Effective Date can used to determine when the pricing, business logic and structure became or will 
become valid. 


BNS 595.5 - EDDMR_RCALC_CR v1 - Allow EDDM-R to get pricing 30 days out 
Allow the users of the customer map 028R6 to request pricing for a shipping date 30 days in the future. 


Updated Holidays 
The Holiday data has been updated to reflect the 2017 Holidays. 


| Date Holiday 
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Monday, January 2 
Thanksgiving Day 


Move APO/FPO/DPO Validation Table into Database 
The Domestic Pricing Engines where updated to pull the APO/FPO/DPO Validation table from the 
database. 


Impact on Existing Applications 
You will have to rebuild your applications. 


Instructions 
1. Copy the DLLs 
2. Restore the databases (SQL Server 2012 backups). The database backups are not included and 
can be downloaded separately. Note: the SQL script files have been included in the package for 
those that cannot restore the SQL Server 2012 backups. SQL Scripts should be executed in the 
order shown below. 


Note: The batch can be executed with a parameter that specifies the database name. The default 
database names are “USPS DOM_2017_01” and “USPS_INTL_2017_01” 


Mu 


i.e.: > “Execute Domestic Price Change Updates.bat” “[your database name]” 


Contents 


Description 
Folder Database 
Folder Domestic 
Folder CR7548 
Batch File CR7548_ Database Performance Improvements. bat 
SQL Scripts and FMT os 
Folder CustomerMaps 
SQL Script CreateClient_EDDMR_028R6.sq| 
SQL Script CR 7085.sq| 
SQL Script BNS 483.sql 
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SQL Script 
SQLScript 
SQLScript 
SQLScript 
SQLScript 
SQLScript 
SQLScript 
SQLScript 
SQL Script 
SQLScript 
SQL Script 
SQLScript 
SQL Script 
SQLScript 
SQL Script 
Batch File 
Folder 
Folder 
Batch File 
SQL Scripts 
Folder 
Batch File 
SQL Scripts 
SQLScript 
SQLScript 
SQLScript 
SQL Script 
SQLScript 
SQL Script 
SQLScript 
SQLScript 
SQLScript 
SQL Script 
Batch File 
Folder 
Rate Engine Framework 
Business Framework 
Domestic Business Rate Engine 
International Business Rate Engine 
Service Delivery Extensions 
Customs Forms Engine 
Design Model 
Release Notes 


BNS 600.sq| 

BNS 548.sql 

BNS 561.sql 

BNS 593.sql 

BNS 580.sql 

BNS 392.sql 

BNS 411.sql 

BNS 560.sql 

BNS 595 Domestic - Competitive.sql 

BNS 595 Domestic - Market Dominant. sql 
BNS 595 Mailing Fees.sql 

CR 7795.sql 

BNS 595 CR 595-5. sql 

CR 7965.sq| 

CR 7988. sq| 

Execute Domestic Price Change Updates. bat 
International 

CR7548 

CR7548_ Database Performance Improvements.bat 


CustomerMaps 
Execute International Customer Maps Updates. bat 


CR 7085.sq| 

CR 7795.sq| 

BNS 530-1.sql 

BNS 530-2.sql 

BNS 530-3.sql 

BNS 595 International - Market Dominant.sql 
BNS 530 ECOMPRO Create Tables. sql 

BNS 595 International - Competitive. sq 

BNS 595 Mailing Fees.sql 

CR 6766.sq| 

Execute International Price Change Updates.bat 
Libraries 

RateEngine_Framework.dll 
RateEngine_Business. dll 
RateEngine_DomBusiness. dll 
RateEngine_Int|lBusiness.dll 
ServiceDeliveryExtensions. dll 
CustomsFormsEngine.dll 

Pricing Engine Design Model. pdf 

USPS Pricing Engine SDK 11_5 0 _O.pdf 


Reported Defects and Change Request 
[10 [tite Status 
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7834 
7836 


7946 | BNS 530 - Priority Mail heading is missing for some countries 


8273 | BNS595 - The Nonbarcoded Surcharge for USPS Marketing Mail Parcels is not Corrected 
elo A 
8277 | BNS 595 - All Prices for Parcel Select Lightweight Machinable Parcels are Corrected 
| incorrect aoe 
8501 | International Dynamic Prefix Bar Code Assignment - Bhutan missing from Corrected 
fail ECOMPRO list eee | 


BUG 7693 - BNS 561 - USPS Marketing Mail CR Flats is still showing DFSS 


Steps to Reproduce 
Remove DFSS as a Destination Entry from: 


e USPS Marketing Mail Flats 
o Carrier Route Flats 
= High Density Plus 
= High Density 


Acceptance Criteria 
The DFSS rates are no longer shown 


BUG 7834 - BNS 595 - Costs of Fragile is not being calculated properly 


Steps to Reproduce 
1. Execute the domestic retail calculator, postcalc-sit2.usps.com 


Choose "Check if the mail piece contains anything Fragile" 
Choose weight as 1 ounce 

Click Continue. 

Expand First-Class and Other Options 

Check the price for First-Class Mail Parcel 


The price displayed is 12.62 = 2.67+ 9.95 


Acceptance Criteria 
The price should be 12.92 = 2.67+ 10.25 


BUG 7835 - International Zone Chart displays an odd error 


Steps to Reproduce 
1. Open International Postal Zone Chart 
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2. Enter"345" in the text box 
3. Click "Get Zone Chart" 


The error displayed: Data is Null. This method or property cannot be called on Null values. 


Acceptance Criteria 
The error should be: The ZIP Code you have entered is invalid. 


BUG 7836 - BNS 595 - EDDM at Retail Price is incorrect 


Steps to Reproduce 
Open the domestic business calculator 
Choose Flat 
Choose Every Door Direct Mail (EDDM) 
Observe the price for Every Door Direct Mail (EDDM) at Retail. 


The price displayed is 0.176 


Acceptance Criteria 
The price should be 0.177 for the Jan 2017 Price Change. 


BUG 7939 - BNS 530 - PMI not being returned for Canada 


Steps to Reproduce 
Launch https://ircalc-cat4.usps.com/ 


Select Canada from the Country dropdown list 

Enter Item's value - 200 

Select Large Package - Enter 2 ounces for weight 

Click "Continue" 

Enter the From Zip Code - 20120 

Enter the To Zip Code - E4H and click "Continue" 

Under the Priority Mail Option please note that the PMI option is missing 


Acceptance Criteria 
PMI is returned for Canada 


BUG 7946 - BNS 530 - Priority Mail heading is missing for some countries 


Steps to Reproduce 
Launch https://ircalc-cat4.usps.com 


Select Belgium under the Country dropdown 

Enter 200 for item value 

Click on PMI Legal Flat Rate envelope under Select a Flat rate service 
Notice that Priority Mail International Options heading is missing 
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5. Notice that under Expected Delivery Date - the following is not displayed correctly: 6 - 10 
business days to many major markets1,2 


Missing some information on Mailing Service Summary page 
Steps to recreate: 


Select Country - Belgium 

Item value - 200 dollars 

Package - 2 ounces 

Select Priority Mail International 

Click on "Custom Forms and Extra Services" 

Click "Continue" 

Please note that under Expected Delivery Date to Belgium is 6 - 10 business days to many major 
markets1, 2 the below information is missing on the Mailing Service Summary page 


1. Average performance to major markets. 


2. Actual transit time may vary for origin and destination 


Acceptance Criteria 
Pages are update to match PROD 


BNS 595 - The Nonbarcoded Surcharge for USPS Marketing Mail Parcels is not 
correct 


Steps to Reproduce 
1. dbcalc 
USPS Marketing Mail Parcels 


2 

3. Preported Marking Parcels 

4. Check for nonbarcoded parcels (a $0.061 surcharge will apply to SCF, NDCand Mixed NDC 
pieces). is incorrect 


Acceptance Criteria 
The cost should be $0.062 


BNS 595 - All Prices for Parcel Select Lightweight Machinable Parcels are 
incorrect 


Steps to Reproduce 


1. dbcalc 
2. ParcelSelect Lightweight 
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3. Machinable Parcels 
4. enterany weight 
5. incorrect prices 


Acceptance Criteria 
The price will match the spreadsheet 


BUG 8501 International Dynamic Prefix Bar Code Assignment - Bhutan 
missing from ECOMPRO list 


Steps to Reproduce 
Bhutanis returning a FALSE attribute for ECOMPRO. 


Open the International Test Tool version 11.5 

Click on GetServiceWithPricing tab 

Enter the following: Caller ID - 4, Src ID - 4, Customer Type 004R4 

Select Letter, Large Letter 

Enter 20120 from Zip Code and 10039 as Country ID 

Enter 2 ounces in weigth and click on Get 

When the dats is returned expand the selection for PMI and look at one of the attributes. 
ECOMPRO attribute shows as False. 


ONaU PWN 


Acceptance Criteria 
ECOMPRO attribute should be displayed as True. 
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